package com.zhaowb.springcloud.common.service;

import java.util.List;
import java.util.Objects;

/**
 * Created with IDEA
 * 公共接口
 *
 * @author zhaowb
 * @date 2018/10/22 22:44
 */
public interface BaseService<T> {


    /**
     * 根据实体中的属性进行查询，只能有一个返回值，有多个结果是抛出异常，查询条件使用等号
     *
     * @param entity
     * @return
     */
    T selectOne(T entity);

    /**
     * 根据主键字段进行查询，方法参数必须包含完整的主键属性，查询条件使用等号
     *
     * @param id
     * @return
     */
    T selectById(Object id);

    /**
     * 根据实体中的属性值进行查询，查询条件使用等号
     *
     * @param entity
     * @return
     */
    List<T> selectList(T entity);

    /**
     * 查询全部结果
     *
     * @return
     */
    List<T> selectListAll();

    /**
     * 根据实体中的属性查询总数，查询条件使用等号
     *
     * @param entity
     * @return
     */
    int selectCount(T entity);

    /**
     * 保存一个实体，null的属性也会保存，不会使用数据库默认值
     *
     * @param entity
     */
    void insert(T entity);

    /**
     * 保存一个实体，null的属性不会保存，会使用数据库默认值
     *
     * @param entity
     */
    void insertSelective(T entity);

    /**
     * 根据实体属性作为条件进行删除，查询条件使用等号
     *
     * @param entity
     */
    void delete(T entity);

    /**
     * 根据主键字段进行删除，方法参数必须包含完整的主键属性
     *
     * @param id
     */
    void deleteById(Object id);

    /**
     * 根据主键更新实体全部字段，null值会被更新
     *
     * @param entity
     */
    void updateById(T entity);

    /**
     * 根据主键更新属性不为null的值
     *
     * @param entity
     */
    void updateSelectiveById(T entity);

    /**
     * 根据Example条件进行查询
     *
     * @param example
     * @return
     */
    List<T> selectByExample(Object example);

    /**
     * 根据Example条件进行查询总数
     *
     * @param o
     * @return
     */
    int selectCountByExample(Objects o);
}
